<?php

namespace Illuminate\Support;

use DateInterval;
use DateTimeInterface;

/**
 * 与时间交互工具
 */
trait InteractsWithTime
{
    /**
     * 获取距给定日期时间之前的秒数
     *
     * @param  \DateTimeInterface|\DateInterval|int $delay
     * @return int
     */
    protected function secondsUntil($delay)
    {
        $delay = $this->parseDateInterval($delay);

        return $delay instanceof DateTimeInterface
            ? max(0, $delay->getTimestamp() - $this->currentTime())
            : (int)$delay;
    }

    /**
     * 获取一个到指定时间的 UNIX 时间戳
     *
     * @param  \DateTimeInterface|\DateInterval|int $delay
     * @return int
     */
    protected function availableAt($delay = 0)
    {
        $delay = $this->parseDateInterval($delay);

        return $delay instanceof DateTimeInterface
            ? $delay->getTimestamp()
            : Carbon::now()->addRealSeconds($delay)->getTimestamp();
    }

    /**
     * 如果给定值是一个时间间隔类型，则将其转换为 DateTime 实例
     *
     * @param  \DateTimeInterface|\DateInterval|int $delay
     * @return \DateTimeInterface|int
     */
    protected function parseDateInterval($delay)
    {
        if ($delay instanceof DateInterval) {
            $delay = Carbon::now()->add($delay);
        }

        return $delay;
    }

    /**
     * 以 UNIX 时间戳的形式获取当前系统时间
     *
     * @return int
     */
    protected function currentTime()
    {
        return Carbon::now()->getTimestamp();
    }
}
